home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / wheelmenu / wheelmenu.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  10.5 KB  |  248 lines  |  [TEXT/ttxt]
  1.  
  2.           Wheel Menu - Copyright (C) by Fabio Ciucci 1998/99
  3.  
  4.  
  5. This applet is a 3D navigational menu: it can display up to 8 menu's, 
  6. with 8 items in each menu. 
  7.  
  8. Note: the labels can't contain numbers or special characters, and will
  9. be considered all as uppercase.
  10.  
  11. The link feature works only when you are registered by paying for the 
  12. shareware. 
  13.  
  14. This applet contains code by Dolf van der Schaar & Andrea Fasce which 
  15. is used under a licence.
  16.  
  17. ***********************************************************************
  18.  
  19. NECESSARY FILES.
  20.  
  21. As well as a font file, and a background and/or a foreground and/or a 
  22. texture images, the following 3 ".class" files must be uploaded: 
  23.  
  24. wheelmenu.class
  25. Lware.class
  26. anfy.class
  27.  
  28. Plus, wheelmenu.jar for speedy loading on recent browsers.
  29.  
  30. ***********************************************************************
  31.  
  32. Insert the <applet> tag in your html document as follows to add this applet
  33. to your page (Comments after the ";" symbol are code explanations and
  34. acceptable min/max values. They are not part of the applet language):
  35.  
  36.  
  37. <applet archive="wheelmenu.jar" code="wheelmenu.class" width="240" height="180">
  38. <param name="credits" value="Applet by Anfy Team (www.anfyteam.com)">
  39. <param name="regcode" value="NO">         ; Registration code (if you have it)
  40. <param name="regnewframe" value="YES">    ; Reglink opened in new frame?
  41. <param name="regframename" value="_blank"> ; Name of new frame for reglink
  42. <param name="filter" value="1">          ; Filter (0=none, 1=smooth, 2=colorize)
  43. <param name="font" value="1">            ; Font (0=font0.class, 1=font1.class)
  44. <param name="background" value="image">  ; backgr. mode ("color","blur","image")
  45. <param name="backimage" value="back.jpg"> ; Background image (in "image" mode)
  46. <param name="bgcolor" value="ffffff">    ; Background colour (hex rrggbb)
  47. <param name="wheelcolor" value="0000ff"> ; Wheel colour (only in gouraud mode)
  48. <param name="textcolor" value="880000">  ; Text colour (only in gouraud mode)
  49. <param name="selectcolor" value="ff0000"> ; Selection colour (gouraud only)
  50. <param name="flat" value="no">           ; Remove extrusion ("yes" or "no")
  51. <param name="mouseSens" value="200">   ; Up/Down Mouse sensivity (-1000 .. 1000)
  52. <param name="YRotation" value="3">     ; Left/Right mouse sensivity (0 .. 20)
  53. <param name="offsetStep" value="10">   ; Speed of submenu change (1 .. 100)
  54. <param name="statusbar_y" value="10">  ; Optional link-statusbar y position
  55. <param name="mode" value="texture">     ; Mode ("gouraud" or "texture")
  56. <param name="texture" value="fire.jpg"> ; Texture to use (only if mode=texture)
  57. <param name="extrudediff" value="2">    ; Darkness of extrusion (mode=texture)
  58. <param name="textdiff" value="1">       ; Darkness of text (mode=texture)
  59. <param name="floatmode" value="NO">       ; Float mode ("YES" or "NO")
  60. <param name="floatw" value="200">         ; Float window width
  61. <param name="floath" value="280">         ; Float window height
  62. <param name="floatx" value="100">         ; Float window x position start
  63. <param name="floaty" value="100">         ; Float window y position start
  64. <param name="floatitle" value="Wheel Menu"> ; Float window title
  65. <param name="floatinfront" value="NO">    ; Float win. always on top (YES,NO)
  66.  
  67. <param name="MenuText00" value="SUB ONE">   ; Text menu 0 item 0
  68. <param name="MenuLink00" value="1">         ; Menu Link menu 0 item 0: submenu 1
  69.  
  70. <param name="MenuText01" value="HELLO">     ; Text menu 0 item 1
  71.                                           ; No links for menu 0 item 1
  72.                                           ; No Target for Url link menu 0 i. 1
  73.  
  74. <param name="MenuText02" value="LINK ONE">  ; Text menu 0 item 2
  75. <param name="MenuUrl02" value="test1.html"> ; Url Link menu 0 item 2
  76.                                           ; No Target for Url link menu 0 i. 2
  77.  
  78. <param name="MenuText03" value="LINK TWO">  ; Text menu 0 item 3
  79. <param name="MenuUrl03" value="test2.html"> ; Url link menu 0 item 3
  80. <param name="MenuTarget03" value="mypage">  ; Target for url link menu 0 item 3
  81.  
  82. <param name="MenuText10" value="BACK">      ; Text menu 1 item 0
  83. <param name="MenuLink10" value="0">         ; Menu link menu 1 item 0: go back
  84.  
  85. <param name="MenuText12" value="ITEM ONE">  ; Text menu 1 item 2
  86. <param name="MenuUrl12" value="test1.html"> ; Url link menu 1 item 2
  87.                                           ; No Target for Url link menu 1 i. 2
  88.  
  89. <param name="overimg" value="NO">          ; Optional image over applet
  90. <param name="overimgX" value="0">          ; Over image X offset
  91. <param name="overimgY" value="0">          ; Over image Y offset
  92. <param name="memdelay" value="1000">       ; Memory deallocation delay
  93. <param name="priority" value="3">          ; Task priority (1..10)
  94. <param name="MinSYNC" value="10">          ; Min. milliseconds/frame for sync
  95. Sorry, your browser doesn't support Java.; Message for no java browsers.
  96. </applet>                                ; End of applet tag
  97.  
  98. ******************************************************************************
  99.  
  100. INSTRUCTIONS.
  101.  
  102. The following instructions describe how to change parameters:
  103.  
  104. Attempting to change the credits parameter will disable the applet.
  105.  
  106. To activate the reg parameters read the shareware registration notes.
  107. In the "regcode" parameter, place the registration code you purchased 
  108. from the author. If the code is correct and the applet is run from the 
  109. registered domain name, you can use "link" parameters to link to a URL
  110. when the applet is "clicked".
  111.  
  112. If you set "regnewframe" to "YES", you can specify a specific frame 
  113. location for the menu links:
  114.  
  115. "_blank"  : To load the link in a new blank unnamed browser window.
  116. "_self"   : To load the link into the same window the applet occupies.
  117. "_parent" : To load the link into the immediate FRAMESET parent.
  118. "_top"    : To load the link into the top body of the window.
  119.  
  120. You can also set a custom frame name, such as "myframe1".
  121.  
  122. Note: you can specify a specific target for a selected menu item, using the
  123. parameter called "MenuTargetXX". If no "MenuTargetXX" is specified, 
  124. regnewframe is used. Here, XX represents a numeric symbol. You need to set
  125. this parameter for each item.
  126.  
  127. With "filter" parameter, you can activate a smoothing/antialiasing filter; 
  128. the values are 0=none, 1=smooth, 2=colorize.
  129.  
  130. With "font" parameter you can choose a font. Actually, only 2 fonts are 
  131. available with the values "0" = font0.class (5 Kb), and 1 = font1.class 
  132. (10 Kb). Remember to copy the font you use, together with other datas, on 
  133. the site.
  134.  
  135. With "background" parameter, you can choose the background mode: the "color"
  136. mode requires to set the parameter "bbcolor" parameter.
  137. The "blur" mode sets the background as black, and adds a motion blur effect.
  138. The "image" parameter requires to specify an image in "backimage" parameter.
  139. This image must be equal to the applet size.
  140.  
  141. You can choose to "extrude" the letters, or not, with the "flat" parameter.
  142. With flat=yes, the letters are not extruded. With "no", letters are extruded.
  143.  
  144. You can control the Up/Down and Left/Righ Mouse sensivity with "mouseSens"
  145. and "YRotation" parameters respectively.
  146.  
  147. With "offsetStep" you decide the speed of sub-menu appearances.
  148.  
  149. With "statusbar_y" you can decide the position of the text link statusbar.
  150. If you place here a value bigger than the height of the applet, the
  151. text will not be displayed. This line will be printed with the colour 
  152. specified at "textcolor" parameter.
  153.  
  154. With the "mode" parameter you choose between "gouraud" and "texture".
  155.  
  156. With "gouraud" mode, you activate the shading, and you have to choose
  157. the colour of wheels, with "wheelcolor", "textcolor" and "selectcolor".
  158.  
  159. With "texture" mode, you disable the shading and use a texture, with 
  160. a specified gif or jpg file in the parameter "texture": this image must 
  161. be exactly 256x256 in pixels.
  162.  
  163. Then, you can specify how the unselected text is darker with "textdiff"
  164. parameter, and how the extrusion is darker, with "extrudediff" parameter.
  165.  
  166.  
  167. *****
  168.  
  169. [The floating mode:]
  170.  
  171. Optionally, you can enable the "floating window" mode.
  172. The treemenu applet, then, will appear in a floating external window, and will
  173. leave free all the other frame space on the web site.
  174. But, you still have to create a small horizontal or vertical frame (maybe
  175. 1 or 2 pixels large), containing the applet, 1 pixel large.
  176.  
  177. To enable this mode:
  178.  
  179. 1) Set "floatmode" to "YES"
  180. 2) Copy the applet width in the "floatw" parameter
  181. 3) Copy the applet height in the "floath" parameter
  182. 4) Set the applet width=1 and height=1
  183.  
  184. At this point, you just have to customize it using those parameters:
  185.  
  186. The window title must be written in the "floatitle" parameter.
  187.  
  188. The starting X and Y position where window should apper, must be written
  189. in the "floatx" and "floaty" parameters. Note: the coordinates are relative
  190. to user screen, so result can change depending on screen resolution.
  191.  
  192. If you want the window to be always on top and visible, set the "floatinfront"
  193. parameter to "YES". This could be useful for someone, and annoying for others.
  194.  
  195. Note: the "floatinfront" option will have no effect on some versions of
  196. Internet Explorer.
  197.  
  198.  
  199. *****
  200.  
  201. [Menu System:]
  202.  
  203. This menu applet can display up to 8 items in each wheel, and up to 8 wheels.
  204. Each item is defined with a menu identifier + an item identifier.
  205.  
  206. For example, 00 means menu 0, item 0; 10 means menu 1, item 0; 22 means
  207. menu 2, item 2, and so on.
  208.  
  209. The numeration starts from 0, so the max item is 7, and the max menu is 7.
  210.  
  211. Each item should have a Text label:
  212.  
  213. <param name=MenuText00 value="SUB ONE">   ; Text menu 0 item 0
  214.  
  215. The text can't contain numbers or special characters.
  216.  
  217. Each menu item can have (or not have) a link.
  218. The link can be of 2 types: MenuLinkXX or MenuUrlXX:
  219.  
  220. <param name=MenuLink00 value="1">        ; Menu Link menu 0 item 0: submenu 1
  221. <param name=MenuLink10 value="0">        ; Menu link menu 1 item 0: go back
  222.  
  223. A MenuLink indicates either to go to next sub wheel menu, or to go back
  224. to previous menu.
  225.  
  226. To specify the submenu, you simply set: 0,1,2,3,4,5,6... and you can go
  227. more than one step deeper, if you want.
  228.  
  229. For instance, when you are on menu 2, you can go to submenu 3, or even to 
  230. submenu 4 or 5, etc. To go back to previous menu, just specify the number 
  231. of the menu from where you were linked to the current one.
  232.  
  233. NOTE: since you can go to the previous menu clicking on the left of the
  234. applet window, you aren't obliged to specify a "BACK" item.
  235.  
  236. When an item is a MenuUrl, you should specify a http:// or relative link 
  237. to a file:
  238.  
  239. <param name=MenuUrl02 value="test1.html"> ; Url Link menu 0 item 2
  240.  
  241. And, optionally, you can specify a target frame:
  242.  
  243. <param name=MenuTarget02 value="mypage">  ; Target for url link menu 0 item 3
  244.  
  245. If no target frame is specified, the "regframename" will be used.
  246.  
  247.  
  248.